|
CapsLockState | getCapsLock () const |
| Returns the required Caps Lock state for the key gesture.
|
|
pair< LogicalKey, KeyModifier > | getKey () const |
| Returns the composing elements of a key gesture.
|
|
void | setCapsLock (CapsLockState capsLock) |
| Sets the required Caps Lock state for the key gesture.
|
|
void | setKey (LogicalKey key) |
| Sets the key gesture composed of a logical key value with no key modifier.
|
|
void | setKey (LogicalKey key, KeyModifier modifiers) |
| Sets the key gesture composing elements to handle.
|
|
void | attach (Node &node) |
| Attaches an input manipulator to a node.
|
|
void | cancel () |
| Notify manipulator of touch canceling.
|
|
void | detach () |
| Detaches an input manipulator.
|
|
Node * | getAttachedNode () const |
| Gets the node to which the input manipulator is attached.
|
|
InputManipulator * | getDependantManipulator () const |
| Gets the dependant input manipulator.
|
|
EventRoutingMode | getEventRoutingMode () |
| Returns the current input event routing mode.
|
|
InputManipulatorWeakPtr | getFailManipulator () const |
| Gets the fail manipulator.
|
|
State | getState () const |
| Get the state of an input manipulator.
|
|
KZ_DEPRECATED TouchEventRoutingMode | getTouchEventRoutingMode () |
| Returns the current touch event routing mode.
|
|
ManipulatorType | getType () const |
| Returns the type of the input manipulator.
|
|
bool | isActive () const |
| Checks whether an input manipulator is in active state.
|
|
bool | isAttached () const |
| Tells whether the input manipulator is attached to a node.
|
|
bool | isCancelable () const |
| Returns whether an input manipulator is in a cancelable state.
|
|
bool | isResettable () const |
| Returns whether an input manipulator is in a resettable state.
|
|
void | requireToFail (InputManipulatorWeakPtr manipulatorToFail) |
| Sets the input manipulator that must fail before Kanzi can recognize this input manipulator.
|
|
void | reset () |
| Reset the manipulator.
|
|
void | setEventRoutingMode (EventRoutingMode mode) |
| Sets the input event routing mode that you want the input manager to use when distributing the input event data to manipulators.
|
|
void | setReferenceNode (NodeWeakPtr referenceNode) |
| Override the attached node as the hit test reference node.
|
|
void | setState (State state) |
| Set the state of an input manipulator.
|
|
KZ_DEPRECATED void | setTouchEventRoutingMode (TouchEventRoutingMode mode) |
| Sets the touch event routing mode that you want the input manager to use when distributing the touch points to input manipulators.
|
|
| ~InputManipulator () override |
| Destructor.
|
|
AppliedStyleEntrySharedPtr | applyObjectStyle (kanzi::StyleSharedPtr style) |
| Applies a style to an object.
|
|
void | applyObjectStyles () |
| Apply all styles for an object node.
|
|
Domain * | getDomain () const |
| Returns the domain the object belongs to.
|
|
const Metaclass * | getDynamicMetaclass () const override |
| Returns the metaclass of the dynamic type of the object.
|
|
MainLoopScheduler * | getMainLoopScheduler () const |
| Returns the MainLoopScheduler instance of the associated Domain.
|
|
detail::MessageDispatcher * | getMessageDispatcher () const |
| Returns the message dispatcher of the object.
|
|
ResourceManager * | getResourceManager () const |
| Returns the resource manager of the object.
|
|
ScriptingContextSharedPtr | getScriptingContext () const |
| Gets the scripting context of the object.
|
|
| Object (Domain *domain) |
|
void | setScriptingContext (ScriptingContextSharedPtr context) |
| Sets the scripting context of the object.
|
|
void | unapplyObjectStyle (AppliedStyleEntrySharedPtr appliedStyleEntry) |
|
void | unapplyObjectStyles () |
| Unapplies and removes all applied styles.
|
|
| ~Object () override |
|
bool | isTypeOf (const Metaclass *objectType) const |
| Determines if the type of this object is the given type or derived from it.
|
|
virtual | ~MetaObject () |
|
template<typename DataType > |
void | addPropertyModifier (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner) |
|
template<typename DataType > |
void | addPropertyModifierWithoutNotifyingHandlers (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner) |
| Adds a property modifier without notifying handlers.
|
|
template<typename DataType > |
void | addPropertyNotificationHandler (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::NotificationCallback callback, void *owner) |
|
template<typename DataType > |
void | addPropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, PropertyValuePrecedence precedence, AbstractPropertyTypeDescriptor::ValueSourceOwner *owner) |
|
template<typename DataType > |
void | addPropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, PropertyValuePrecedence precedence, void *ownerPointer) |
|
PropertyStorageContainer::iterator | beginPropertyStorage () |
| Returns the begin iterator to the internal property storage container.
|
|
PropertyStorageContainer::const_iterator | beginPropertyStorage () const |
| Returns the begin iterator to the internal property storage container.
|
|
void | clearPropertyFlag (AbstractPropertyType propertyType, uint32_t flag) |
|
void | copyLocalValue (const PropertyObject &other, AbstractPropertyType propertyType) |
| Copies local value of single property from another object.
|
|
void | copyLocalValues (const PropertyObject &other) |
| Copies all local values from another object.
|
|
PropertyStorageContainer::iterator | endPropertyStorage () |
| Returns the end iterator to the internal property storage container.
|
|
PropertyStorageContainer::const_iterator | endPropertyStorage () const |
| Returns the end iterator to the internal property storage container.
|
|
template<typename DataType > |
PropertyType< DataType >::Traits::ReturnType | getAbstractProperty (AbstractPropertyType abstractPropertyType) const |
|
template<typename DataType > |
PropertyType< DataType >::Traits::ReturnType | getAbstractPropertyBase (AbstractPropertyType abstractPropertyType) const |
|
template<typename DataType > |
optional< typename PropertyType< DataType >::Traits::ReturnType > | getOptionalAbstractProperty (AbstractPropertyType abstractPropertyType) const |
|
template<typename DataType > |
optional< typename PropertyType< DataType >::Traits::ReturnType > | getOptionalProperty (const PropertyType< DataType > &propertyType) const |
| Evaluates the property value in the same way as the overload above but does not default to the value in property metadata if there are no inputs to the property value.
|
|
template<typename DataType > |
optional< typename PropertyType< DataType >::Traits::ReturnType > | getOptionalPropertyBase (const PropertyType< DataType > &propertyType) const |
| Returns the current value of a property disregarding modifiers, but does not default to the value in property metadata if there are no inputs to the property value.
|
|
template<typename DataType > |
PropertyType< DataType >::Traits::ReturnType | getProperty (const PropertyType< DataType > &propertyType) const |
| Returns the current value of a property type.
|
|
template<typename DataType > |
PropertyType< DataType >::Traits::ReturnType | getPropertyBase (const PropertyType< DataType > &propertyType) const |
| Returns the current value of a property disregarding modifiers.
|
|
template<typename DataType > |
size_t | getPropertyNotificationHandlerCount (const PropertyType< DataType > &propertyType) const |
| Gets number of current notification handlers for given property type.
|
|
bool | hasBaseValue (AbstractPropertyType propertyType) const |
| Evaluates whether there are any inputs into the property value, disregarding modifiers.
|
|
bool | hasLocalValue (AbstractPropertyType propertyType) const |
| Evaluates whether there is a local value set for the property.
|
|
bool | hasNonClassValue (AbstractPropertyType propertyType) const |
| Evaluates whether there is a value of any precedence higher than class default value set for the property.
|
|
bool | hasValue (AbstractPropertyType propertyType) const |
| Evaluates whether there are any inputs into the property value.
|
|
bool | isPropertyFlagSet (AbstractPropertyType propertyType, uint32_t flag) const |
|
virtual void | onPropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason) |
| Virtual function to handle property change notifications.
|
|
| PropertyObject () |
|
void | removeKzbProperties () |
| Remove all KZB properties.
|
|
void | removeKzbProperties (flat_set< AbstractPropertyType > *keepProperties) |
| Remove all KZB properties that are not included in a given set.
|
|
template<typename DataType > |
void | removeLocalPropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, void *ownerPointer) |
|
void | removeLocalValue (AbstractPropertyType propertyType) |
| Removes the local value associated with the property.
|
|
template<typename DataType > |
void | removePropertyModifier (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner) |
|
template<typename DataType > |
void | removePropertyNotificationHandler (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::NotificationCallback callback, void *owner) |
|
template<typename DataType > |
void | removePropertyValueSource (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::TypedValueSource *valueSource, void *ownerPointer) |
|
template<typename DataType > |
void | setAbstractProperty (AbstractPropertyType abstractPropertyType, typename PropertyType< DataType >::Traits::ParameterType value) |
|
template<typename DataType > |
void | setProperty (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Traits::ParameterType value) |
| Sets the local value of a property type.
|
|
void | setPropertyFlag (AbstractPropertyType propertyType, uint32_t flag) |
|
KZ_DEPRECATED void | validatePropertyModifiers (AbstractPropertyType propertyType) |
| Validates property modifiers and notifies handlers.
|
|
void | validatePropertyModifiersAndNotifyHandlers (AbstractPropertyType propertyType) |
| Validates property modifiers and notifies handlers.
|
|
virtual | ~PropertyObject () |
|
|
| KeyManipulator (Domain *domain) |
| Constructor.
|
|
bool | notifyKeyInput (const KeyEvent &event) override |
| Overrides InputManipulator::notifyKeyInput().
|
|
void | onCancel () override |
| Overrides InputManipulator::onCancel().
|
|
void | onKeyPressGesture (KeyGestureInfo &) override |
| Overrides InputManipulator::onKeyPressGesture().
|
|
void | onKeyReleaseGesture (KeyGestureInfo &) override |
| Overrides InputManipulator::onKeyPressGesture().
|
|
void | onReset () override |
| Overrides InputManipulator::onReset().
|
|
void | addHitTestArguments (MessageArguments &message, const TouchPoint &touchPoint) |
| Add hit test information arguments to the message from the touch point.
|
|
bool | detectKeyGesture (const KeyEvent &event, KeyGestureInfo &gesture) |
| Detects key gestures from the event that you pass as an argument.
|
|
Node2D * | findNearestParent2D () |
| Find the 2D manipulator node for this input manipulator.
|
|
InputManager * | getInputManager () const |
| Get the attached input manager of an input manipulator.
|
|
| InputManipulator (Domain *domain, ManipulatorType type=ManipulatorType::TouchInputHandler) |
| Constructor.
|
|
virtual bool | isCancelableOverride () const |
| Overridable check for the cancelable status of an input manipulator.
|
|
virtual bool | isResettableOverride () const |
| Overridable check for the resettable status of an input manipulator.
|
|
void | markTouchPointConsumed (const TouchPoint &touchPoint) |
| Marks the passed touch point handled.
|
|
virtual void | notifyTouchInside (const TouchInfo &touchInfo) |
| Notify an input manipulator about touch events that occur inside the subtree of the input manipulator.
|
|
virtual void | notifyTouchOutside (const TouchInfo &touchInfo) |
| Notify an input manipulator about touch events that occur outside the subtree of the input manipulator.
|
|
virtual void | onAttach () |
| Attach function for input manipulators.
|
|
virtual void | onDetach () |
| Detach function for input manipulators.
|
|
virtual void | onFail () |
| Fail function for input manipulators.
|
|
virtual void | onPartialKeyPressGesture (KeyGestureInfo &gesture) |
| The detectKeyGesture() method calls this method when it detects a partial key press gesture.
|
|
void | initialize () |
|
void | onCopy (const Object &other) |
|
void | initialize () |
|
| MetaObject () |
|
AbstractPropertyTypeDescriptor::ValueSourceEntry * | acquireLocalValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor, PropertyStoragePtr &propertyStorage) |
| Acquires a local value source entry that is free for the assignment of a value.
|
|
AbstractPropertyTypeDescriptor::ModifierStorage * | acquireModifierStorage (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage) |
|
AbstractPropertyTypeDescriptor::NotificationStorage * | acquireNotificationStorage (AbstractPropertyTypeDescriptor &descriptor) |
|
PropertyStoragePtr | acquirePropertyStorage (AbstractPropertyTypeDescriptor &descriptor) |
|
template<typename DataType > |
void | addPropertyModifierBase (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::Descriptor::ModifierCallback callback, void *owner, bool notify) |
| Adds a property modifier entry to the property modifier stack and validates them.
|
|
void | addPropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, PropertyValuePrecedence precedence, AbstractPropertyTypeDescriptor::ValueSourceOwner *owner) |
| Internally adds a property value source.
|
|
void | addPropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, PropertyValuePrecedence precedence, void *ownerPointer) |
| Internally adds a property value source.
|
|
AbstractPropertyTypeDescriptor::ValueSourceEntry * | constructLocalValueSourceEntry (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::PropertyStorage &propertyStorage) |
|
PropertyStoragePtr | constructPropertyStorage (AbstractPropertyTypeDescriptor &descriptor) |
|
void | copyLocalValue (const AbstractPropertyTypeDescriptor::PropertyStorage &otherPropertyStorage) |
| Copy local value from property storage.
|
|
AbstractPropertyTypeDescriptor::ModifierStorage * | findModifierStorage (AbstractPropertyTypeDescriptor &descriptor) |
|
AbstractPropertyTypeDescriptor::NotificationStorage * | findNotificationStorage (AbstractPropertyTypeDescriptor &descriptor) const |
|
AbstractPropertyTypeDescriptor::PropertyStorage * | findPropertyStorage (AbstractPropertyTypeDescriptor &descriptor) const |
| Gets the property storage for given property type descriptor.
|
|
PropertyStoragePtr | findPropertyStoragePtr (AbstractPropertyTypeDescriptor &descriptor) const |
| Gets property storage intrusive pointer which you can use to hold a reference until the end of the operation.
|
|
AbstractPropertyTypeDescriptor * | findPropertyTypeDescriptorByNameAndDataType (string_view name, PropertyDataType dataType) const |
| Finds a property type descriptor by name and data type.
|
|
AbstractPropertyTypeDescriptor * | findPropertyTypeDescriptorByQualifiedNameAndDataType (string_view qualifiedName, PropertyDataType dataType) const |
| Like findPropertyTypeDescriptorByNameAndDataType, but only searches by matching with qualified names.
|
|
AbstractPropertyTypeDescriptor * | findPropertyTypeDescriptorByUnqualifiedNameAndDataType (string_view unqualifiedName, PropertyDataType dataType) const |
| Like findPropertyTypeDescriptorByNameAndDataType, but only searches by matching with unqualified names.
|
|
AbstractPropertyTypeDescriptor::ValueSource * | getClassValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
|
AbstractPropertyTypeDescriptor::ValueSource * | getFinalValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
|
AbstractPropertyTypeDescriptor::ValueSource * | getNonClassValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
|
AbstractPropertyTypeDescriptor::ValueSource * | getTopValueSource (AbstractPropertyTypeDescriptor &descriptor) const |
| Gets the top-level value source for a given property descriptor.
|
|
virtual void | notifyPropertyHandlers (PropertyStoragePtr &storagePtr, PropertyNotificationReason reason) |
| Notifies all property handlers on a property storage.
|
|
void | onCopy (const PropertyObject &other) |
|
void | removeLocalValue (AbstractPropertyTypeDescriptor &descriptor, PropertyStoragePtr &propertyStorage) |
| Removes a local value from the given property storage.
|
|
void | removePropertyValueSource (AbstractPropertyTypeDescriptor &descriptor, AbstractPropertyTypeDescriptor::ValueSource *valueSource, void *owner) |
| Removes a property value source.
|
|
void | validatePropertyModifiers (PropertyStoragePtr &propertyStorage) |
| Validates property modifiers without notifying handlers.
|
|
void | validatePropertyModifiersAndNotifyHandlers (PropertyStoragePtr &propertyStorage) |
| Validates property modifiers and notifies handlers.
|
|
KeyManipulator class is a key input manipulator that detects key gestures.
Kanzi recognizes a key gesture when it receives an event with a key code and an optional key modifier. When Kanzi recognizes a key gesture, an input manipulator:
- Grabs the gesture.
- Enters the StateBegin state.
- Dispatches to an attached node the KeyPressedMessage with the logical key value and the pressed key modifiers.
The input manipulator that grabs a key gesture continues to stay in the StateBegin state until it receives a key up event with a logical key value, or a key modifier that forms a key gesture.
The key input manipulators are exclusive input manipulators. To handle different key gestures, you can add multiple key manipulators.
To handle the press and release of the A key:
auto keyManipulator = KeyManipulator::create(getDomain());
anyNode->addInputManipulator(keyManipulator);
keyManipulator->setKey(LogicalKey::A);
auto onKeyPressed = [](auto&)
{
};
anyNode->addMessageHandler(KeyManipulator::KeyPressedMessage, onKeyPressed);
auto onKeyReleased = [](auto&)
{
};
anyNode->addMessageHandler(KeyManipulator::KeyReleasedMessage, onKeyReleased);
To handle the Left Control modifier key as a key gesture:
To handle a key gesture composed of the Shift + A keys:
To handle the Left Alt + Left Control modifier keys, set the Left Alt as modifier key:
The key press order matters. Pressing Left Control first and then Left Alt does not result in the same key gesture as pressing first Left Alt, then Left Control. To handle the Left Control + Left Alt key gesture:
- Since
- Kanzi 3.8.0